home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 201-225 / disk_209 / dps / dps.doc < prev    next >
Text File  |  1992-05-06  |  8KB  |  192 lines
  1.                                 DPS
  2.                             Version 1.1
  3.  
  4.                         Author: Allen Norskog
  5.                            April 23, 1989
  6.  
  7.  
  8. PUBLIC DOMAIN NOTICE
  9.  
  10. This program is placed in Public Domain.  It may be freely copied.
  11. I developed this program to suit my own needs.  I hope it will be
  12. useful to others.  The source is included so that you can make
  13. modifications to suit your own needs.  I would appreciate any comments
  14. or bug reports.
  15.  
  16.  
  17. DESCRIPTION
  18.  
  19. DPS is designed to work with the PrintScript program by Pixelations
  20. to provide a page previewer.  PrintScript is a PostScript interpreter.
  21.  
  22. Presently, PrintScript does not include a screen previewer.  This
  23. program addresses this shortcoming.  PrintScript does have the ability
  24. to write a "bitmap" picture to a file.  This program reads in such
  25. a file and displays the "page" on the screen.
  26.  
  27. The main motivation behind DPS, was to have a tool that would show
  28. one's mistakes, such as printing off the page, or not getting things
  29. centered.  For this, one would like something quick.  Generating
  30. a file for DPS is not really quick, but can be two to three times
  31. faster than actually printing.
  32.  
  33. DPS uses a lower resolution picture than what you will probably 
  34. finally print.  The advantage here is that the smaller picture takes 
  35. less time to compute.  Also, the picture file takes less disk or 
  36. memory space than if you generated a hi-res image file.
  37.  
  38. Presently, DPS is set to display one fixed page size -- 8.5 by 11 inches.
  39. How it appears on the screen is dependent of course on your monitor.
  40. With a standard Amiga monitor, it will actually be a bit larger.  Also
  41. the image will be slightly tall - you will notice this a bit, for
  42. example, when drawing a circle.
  43.  
  44. Originally, what I thought I wanted was a full page overview, like that
  45. in the "Overview" window.  Since I couldn't get PrintScript to generate
  46. less than 72 dpi, I had approximately twice as many dots (pixels) in each 
  47. direction than what I originally wanted.  Having the dots available 
  48. anyway, I did the larger main window, and have generally liked it 
  49. better.  One can see the details much more clearly in the main window.
  50. The Overview window is compressed 2X in both directions compared to the
  51. main window.  Each pixel in the Overview image represents 2x2 pixels
  52. in the main window.  If any of the pixels in the 2x2 square is black,
  53. the corresponding pixel in the Overview window will be black.  This
  54. makes sure that (normal black) lines don't disappear -- if you are
  55. going to be printing something in that area, you will see something
  56. on the screen.  However, gray areas get darker (or totally black)
  57. on the Overview window.
  58.  
  59.  
  60.  
  61. CONFIGURING PRINTSCRIPT
  62.  
  63. DPS uses the file output feature of PrintScript.  This file describes
  64. the image in a run-length-encoded manner documented in the PrintScript
  65. manual.  For DPS to work properly, you need to specify that you are
  66. going to use an 8.5 by 11 inch page, with no margins, and at 72 dots
  67. per inch.  
  68.  
  69. You need to run the configuration program on the PrintScript disk to
  70. create a configuration file (Config.ps) that tells PrintScript to write
  71. to a file.  See the manual for information.  Below is a sample session:
  72.  
  73. 1> configure
  74.  
  75. Screen frequency (10-360)? 10            (You may choose from 10 to 72)
  76. Screen angle (0-90)? 45                  (You may choose 0 to 90)
  77. Are you using a preferences printer (Y or N)? N
  78. Width of printable page in inches (1.0 - 14.0)? 8.5
  79. Height of printable page inches (1.0 - 14.0)? 11
  80. Horizontal dots per inch (72-360)? 72
  81. Vertical dots per inch (72-360)? 72
  82. Printer port name or filename (par:, ser: or file)? ram:dps_file
  83. Name of printer driver? File
  84. Unprintable left margin in inches (0.0 - 1.0)? 0.0
  85. Unprintable bottom margin in inches (0.0 - 1.0)? 0.0
  86.  
  87. You may choose a file name other than ram:dps_file.  Just remember
  88. what you called it so you know where to find it.  The file generated
  89. will generally not be too large because of the low resolution
  90. and the compression used.  Thus, you should be able to usually write it
  91. to ram: to speed things up.
  92.  
  93. The first two questions in the configuration example shown above 
  94. relate to settings for half-tone images.  You may want to experiment 
  95. with values here.  See the PrintScript manual or a PostScript manual
  96. for more info.
  97.  
  98. After you run PrintScript on your PostScript file, the output file
  99. should be available to use in DPS.
  100.  
  101.  
  102. RUNNING DPS
  103.  
  104. DPS can be run from either the CLI (like PrintScript), or from the
  105. Workbench.  
  106.  
  107. From the CLI:
  108.  
  109.     You simply type dps followed by the file name.  If you ran the 
  110.     configuration as described above, you would enter at the cli prompt:
  111.  
  112.     1> dps ram:dps_file
  113.  
  114.  
  115. From the Workbench:
  116.  
  117.     The file that DPS will be looking for is given in the ToolTypes for
  118.     the DPS icon (info file).  Find the DPS icon.  Click on it once.
  119.     Select the Workbench-Info menu item from the Workbench screen.  
  120.     Change the ToolTypes line, so "FILE" is pointed to the file you 
  121.     want.  For example, if you used the above configuration, you would
  122.     set the line to be:
  123.  
  124.     FILE=ram:dps_file
  125.  
  126.     Save the changes you made to the info file.  Now the DPS icon is
  127.     ready for use.  Double click on the icon to run DPS.
  128.  
  129.  
  130. When the DPS program is first loaded, it checks if the file specified
  131. is really a PrintScript file.  If the file is okay, it will build an
  132. image for display.  DPS will open a custom interlace screen.  A gray
  133. page was chosen to reduce flicker.  The writing on the page will be
  134. black.  A page outline is displayed, so you can see where the "edges"
  135. will be.  If you write to the edge, that area of the edge will be
  136. reversed, so you can tell that you are attempting to write there.
  137. You are probably too close for what your printer will do.
  138.  
  139. A slider along the right allows you to scroll up and down the page.
  140.  
  141. You can exit DPS by hitting the "close button" in the DPS window, or
  142. use the "Quit" menu option.
  143.  
  144. Another menu item is labeled "Overview".  Selecting this will bring
  145. up what was intended to be a full page view on the screen.  Actually,
  146. it is a couple lines short, so a slider bar is also provided in the
  147. Overview window as well.  The image in the Overview window is half
  148. as wide and half as tall as the image in the main DPS window.  Closing
  149. the Overview window returns you to the main DPS window. 
  150.  
  151.  
  152. ERRORS
  153.  
  154. The file you specify will be checked to see if it is a PrintScript
  155. type file.  If the beginning of the file is not set up like it expects
  156. (see the header definition in the PrintScript manual), it will assume 
  157. that you are trying to read a non-PrintScript file.  DPS will display
  158. a message describing the problem and the program will exit.  Actually
  159. DPS will only require that the "version" be 1 and that "flags" be 1.
  160. All the other fields are ignored for now, so it is important that you
  161. use the setup described above.
  162.  
  163. If DPS is started from the CLI, any error messages will be displayed
  164. in your CLI window.  Thus, you can have a log of any error messages.
  165. If the program is started from the Workbench, error messages may
  166. be displayed in requestors, or a text window that displays briefly.
  167.  
  168.  
  169. MISCELLANEOUS
  170.  
  171. To let you try the DPS program, an example file (dps.circle) is
  172. included.  This file was generate with PrintScript using an adaptation
  173. of one of the example programs in the Adobe "PostScript Language
  174. Tutorial and Cookbook".  To try it type at the the CLI prompt:
  175.  
  176. 1> dps dps.circle
  177.  
  178. OR double click on the dps icon.  The icon has the ToolType set for
  179. "FILE=dps.circle", so that the demo can be readily seen.  Change
  180. the Tool Type entry as described above for actual use.
  181.  
  182.  
  183. Allen Norskog
  184. 900 Whaler's Way
  185. Fort Collins, CO  80525
  186.  
  187. --------------------------
  188. Trademark acknowledgements
  189.  
  190. PrintScript is a trademark of Pixelations
  191. PostScript is a trademark of Adobe Systems, Inc.
  192.